home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / rdir10.zip / RDIR.DOC next >
Text File  |  1991-09-05  |  13KB  |  329 lines
  1.                ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 
  2.               ▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▒▒
  3.               ▒▒░░                                          ░░▒▒
  4.               ▒▒░░  RDIR      Remove Directories      v1.0  ░░▒▒
  5.               ▒▒░░                                          ░░▒▒
  6.               ▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▒▒
  7.               ▒▒░░                                          ░░▒▒
  8.               ▒▒░░  COPYRIGHT (C) 1991  by  Marc Branchaud  ░░▒▒
  9.               ▒▒░░                                          ░░▒▒
  10.               ▒▒░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░▒▒
  11.                ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ 
  12.  
  13.  
  14.  
  15. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  16. █  Origins and Features  █
  17. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  18.  
  19.  
  20.      RDIR has three main inspirations:
  21.  
  22.        (1) The relativly icky taste all other directory-killing programs left
  23.            in my mouth after I'd use them.  RDIR has been designed to
  24.            eliminate ickyness.
  25.  
  26.        (2) The need to erase a directory without the "Are you sure (Y/N)?"
  27.            prompt getting in the way.
  28.  
  29.        (3) The need to erase a directory that exists on more than one drive
  30.            (also without the "Are you sure (Y/N)?" prompt).
  31.  
  32.      Hence, RDIR.  I've included a couple of extra features that I think are
  33.      useful and that I haven't seen before.  These are:
  34.  
  35.         o  The ability to exclude files and/or directories (or even whole
  36.            drives).  At last, a "delete-everything-but" command!
  37.  
  38.         o  A count of directories, files and bytes that are about to get
  39.            zapped.
  40.  
  41.  
  42.  
  43. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  44. █  Disclaimer  █
  45. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  46.  
  47.  
  48.      RDIR is *extremely* powerful!  It deletes hidden and system files or
  49.      directories as well as regular ones (by default you are prompted before
  50.      any read-only files are deleted).  Nevertheless, it is possible to wipe
  51.      out your entire system with one command, and if you use the promptless
  52.      mode you won't even be warned!
  53.  
  54.      So take heed.  Remember that I'm not responsible for anything, and if
  55.      anything you do with RDIR ruins your life or otherwise inconveniences
  56.      you, then you've got no business whining to me about it.
  57.  
  58.  
  59. █▀▀▀▀▀▀▀▀▀█
  60. █  Usage  █
  61. █▄▄▄▄▄▄▄▄▄█
  62.  
  63.  
  64.      RDIR is easy to use for anyone who understands DOS intuitively.  For the
  65.      remaining 5.3 billion of us who don't, here's a few hints and
  66.      instructions.
  67.  
  68.      An RDIR command consists of three parts:
  69.  
  70.        (1) The word RDIR
  71.        (2) Optional commands you want RDIR to recognize
  72.        (3) The name (path) of the directory you want to remove
  73.  
  74.      or, to put it technically, RDIR is used as follows:
  75.  
  76.        RDIR path [options]
  77.  
  78.      If you just enter RDIR by itself, you'll see a brief summary of
  79.      instructions.
  80.  
  81.  
  82.      Ye Path
  83.      ───────
  84.  
  85.          Any legal DOS directory path can be used.  Do NOT include file names
  86.          in the path, as that will confuse RDIR.  Some examples:
  87.  
  88.              COOL       Specifies COOL as a subdirectory of the current
  89.                         directory  (I guess I've just lost any non-intuitive
  90.                         DOS users...).
  91.              \COOL      Specifies COOL as a subdirectory of the root
  92.                         directory.
  93.              ..\COOL    Specifies COOL as a subdirectory of the parent
  94.                         directory.
  95.              \WOW\COOL  Specifies COOL as a subdirectory of the WOW directory.
  96.              D:\COOL    Specifies COOL as a subdirectory of drive D:.
  97.              .          If you specify the current directory, RDIR will not
  98.                         remove it.  Everything inside will be deleted though.
  99.  
  100.          You can also use a wildcard character (* or ?) to tell RDIR that you
  101.          want to remove the same directory from ALL of your hard drives (to
  102.          include floppy drives, use the -f option (see below)).  For example:
  103.  
  104.              ?:\PLANT   Tells RDIR to remove the PLANT directories from all of
  105.                         your hard drives.
  106.              *:\POT     Tells RDIR to remove the POT directories from all of
  107.                         your hard drives.
  108.  
  109.          Do NOT use wildcards anywhere else in the path!  RDIR will not
  110.          recognize them.
  111.  
  112.  
  113.      Ye Options
  114.      ──────────
  115.  
  116.          RDIR recognizes 6 different command options, and they are optional.
  117.          Each option must begin with either a dash (a -) or a slash (a /).
  118.          Each option must be separated by at least one space.
  119.          The five options are:
  120.  
  121.             -?  Help screen
  122.  
  123.             -f  Include floppy drives (when a wildcard drive letter is used).
  124.                 You will be prompted to insert your floppy disk(s).  RDIR is
  125.                 designed to recognize how many floppies your system has,
  126.                 although this hasn't been tested on systems with more than 2
  127.                 floppies.  An empty floppy drive won't screw up RDIR.  The
  128.                 drive will still be scanned, but if there is no diskette in it
  129.                 RDIR will move on.
  130.  
  131.             -q  Quiet mode: no prompts or status lines or warnings.
  132.  
  133.             -r  Delete read-only files without prompting.
  134.                 Notes :> When running in quiet mode, read-only files will NOT
  135.                          be deleted unless you include the -r command.
  136.                       :> Directories marked as read-only will always be removed
  137.                          WITHOUT any prompting no matter which command options
  138.                          you use.  (In fact, DOS doesn't explicitly recognize
  139.                          read-only directories; and you can RmDir them just as
  140.                          you would a normal directory.)
  141.  
  142.             -s  Don't delete subdirectories.
  143.  
  144.   -x<template>  Don't delete files or directories that match the template.
  145.                 For example, -x*.EXE will exclude any .EXE files from
  146.                 deletion.  In order to have to template apply to directories,
  147.                 put a \ at the end: (e.g. -xGAMES\ will exclude any directory
  148.                 called GAMES (and their subdirectories) from deletion).  You
  149.                 can also use wildcards when specifying a directory.  Here are
  150.                 some more examples of the -x command:
  151.                   -xT?.*   Excludes any two-letter files that start with a T.
  152.                   -xD:     Excludes all files and directories on drive D:.
  153.                   -xTRAP\  Excludes any directory named TRAP.
  154.                   -xF*.*\  Excludes any directory that starts with an F
  155.                            (remember: directories can have extenstions too).
  156.                 The -x command can be used up to 10 times in one RDIR command.
  157.  
  158.      The order of options and path does not matter.  RDIR is also case-
  159.      insensitive, so commands such as
  160.  
  161.          RdIr -Q /xf*\ *:\TEmP /f -x*.Bat -X??tEr.*\
  162.  
  163.      will not confuse the program at all.
  164.  
  165.  
  166.      Ye Examples
  167.      ───────────
  168.  
  169.          Here are some examples to help you on your way to the joys of mass
  170.          deletion.
  171.  
  172.  
  173.          Command: RDIR C:\FANGLE
  174.  
  175.           Effect: The directory FANGLE on drive C: (and all of FANGLE's sub-
  176.                   directories) will be removed.
  177.  
  178.  
  179.          Command: RDIR C:\FANGLE -s
  180.  
  181.           Effect: All the files in the directory FANGLE on drive C: will be
  182.                   erased, and if there are no subdirectories in FANGLE then
  183.                   FANGLE itself will also be erased.
  184.  
  185.  
  186.          Command: RDIR C:\Fangle -x*.exe
  187.  
  188.           Effect: All the files, except for .EXE files, in FANGLE on drive C:
  189.                   (and in all of FANGLE's subdirectories) will be removed.
  190.                   Any empty subdirectories will also be removed.
  191.  
  192.  
  193.          Command: RDIR C:\fangle -q
  194.  
  195.           Effect: The directory FANGLE on drive C: (and all of FANGLE's sub-
  196.                   directories) will be removed.  There will NOT be an "Are you
  197.                   sure?" prompt before the fiels are erased!
  198.  
  199.  
  200.          Command: RDIR C:\
  201.  
  202.           Effect: All of drive C: will be erased.
  203.  
  204.  
  205.          Command: RDIR ?:\TOAST
  206.  
  207.           Effect: All the TOAST directories and their subdirectories on all
  208.                   the drives (except the floppies) will be erased.
  209.  
  210.  
  211.          Command: RDIR ?:\toast -f
  212.  
  213.           Effect: All the TOAST directories and their subdirectories on all
  214.                   the drives (including the floppies) will be erased.  You'll
  215.                   be prompted to insert the floppies.
  216.  
  217.  
  218.          Command: RDIR ?:\ -xsystem\
  219.  
  220.           Effect: All directories on all drives, except for directories or
  221.                   subdirectories called SYSTEM, will be removed.
  222.  
  223.  
  224.          Command: RDIR ?:\ -q
  225.  
  226.           Effect: All hard drives will be erased, WITHOUT any warning!
  227.  
  228.  
  229.          Command: RDIR C:\goop -x*.bat -xTEST*.*\
  230.  
  231.           Effect: The directory GOOP on drive C: will be erased, except for
  232.                   any .BAT files and any subdirectories of GOOP that start
  233.                   with TEST.
  234.  
  235.  
  236.      These should give you a good idea of how RDIR works.  Happy deleting!
  237.  
  238.  
  239. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  240. █  Known Problems  █
  241. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  242.  
  243.  
  244.      RDIR has been tested and works on the following systems:
  245.  
  246.         o  Plain 286 AT running DOS 5.0 with 2 floppy drives.
  247.         o  Plain 386 AT running DOS 5.0 with 2 floppy drives.
  248.         o  Good old 8086 XT running MS-DOS 3.3 with 1 floppy drive.
  249.         o  AT&T PC6300 (Olivetti XT) running MS-DOS 3.1 with 1 floppy.
  250.  
  251.      RDIR will NOT WORK on the following systems:
  252.  
  253.         -- At this time there are no known PC system configurations
  254.            that RDIR does not support.  Cool or what eh?
  255.  
  256.  
  257. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  258. █  Solicitation  █
  259. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  260.  
  261.  
  262.      Suggestions, donations, goodwill, charity, jokes, free samples, and other
  263.      gifts can be sent to:
  264.  
  265.  
  266.                CANADA                                U.S.A.
  267.                ──────                                ──────
  268.  
  269.             Marc Branchaud                        Marc Branchaud
  270.             CP 386                   ┌────┐       C/O Pinnacle Software
  271.             Town of Mount Royal      │ OR │       Box 714 Airport Road
  272.             Quebec, Canada           └────┘       Swanton, Vermont
  273.             H3P 3C6                               05488
  274.  
  275.  
  276.      Proper and honorable monetary compensation is considered to be $5.00 or
  277.      even more if you're in a real good mood.  For those of you who are
  278.      suffering through difficult financial times, a simple "Thanks!" is
  279.      enough.
  280.  
  281.  
  282. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  283. █  Support Via Modem  █
  284. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  285.  
  286.  
  287.      If you don't have a modem, don't hesitate to drop me a note in the mail.
  288.      I'm interested in knowing how far my program spreads, and I'd really
  289.      like to hear from you!
  290.  
  291.      For those of you who own a modem, you can contact me (and get some free
  292.      software to boot) at:
  293.  
  294.                ·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·
  295.               :                                                 :
  296.              ::  Pinnacle Software Support BBS -- 514-345-8654  ::
  297.              ::  24 hours per day, at up to 9600 baud (v42bis)  ::
  298.               :                                                 :
  299.                ·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·∙·
  300.  
  301.      This BBS runs as a shell from another BBS.  When you log on, you'll be
  302.      asked a few questions about your system.  Then you'll see a short menu,
  303.      and then a simple  >  prompt.  At the  >  prompt, you can:
  304.  
  305.         o Type  /RDIR  to download the latest version of RDIR.
  306.         o Type  /BBS   to connect to the EMail system.  To send mail to me,
  307.           direct your message to MARC.  I read through the whole system most
  308.           every day (it's not ultra-huge), so it doesn't really matter which
  309.           "message base" you save your message on.
  310.  
  311.      The BBS is run by the friendly folks at Pinnacle Software (the most
  312.      prolific producers of shareware in Canada).  I owe them many thanks.
  313.  
  314.  
  315. █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀█
  316. █  About The Author  █
  317. █▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█
  318.  
  319.  
  320.      Marc Branchaud has been using microcomputers and deleting files since
  321.      1981.  He is currently studying computer science at McGill University.
  322.      He hopes to someday witness the following natural phenomena: a solar
  323.      eclipse; a decent volcanic eruption; a supernova; and free cable TV.
  324.      Marc is currently living with cats.
  325.  
  326.  
  327.                                                         Marc Branchaud
  328.                                                       September 05, 1991
  329.